home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / vstiff.z / vstiff
Text File  |  1998-10-30  |  13KB  |  199 lines

  1.  
  2.  
  3.  
  4. VVVVSSSSTTTTIIIIFFFFFFFF((((1111))))                        IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                         VVVVSSSSTTTTIIIIFFFFFFFF((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      vstiff - TIFF stream viewer
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      vvvvssssttttiiiiffffffff [X toolkitoption...] [vstiff option...] [file]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _v_s_t_i_f_f is a viewer for _S_t_r_e_a_m _T_I_F_F.  Stream TIFF is a subset of TIFF that
  16.      can be read from and written to a stream (no seeking is required).
  17.  
  18.      _v_s_t_i_f_f draws the image represented by a TIFF stream in a Motif window on
  19.      the screen.  If a TIFF stream contains more than one image, the Page Down
  20.      and Page Up keys can be used to traverse the pages.  If an image does not
  21.      fit in the window, the scroll bars can be used.
  22.  
  23.      If _v_s_t_i_f_f is used to open a file that is not a Stream TIFF file, it will
  24.      check to see if it is a PostScript file and if _p_s_r_i_p(1) is installed.  If
  25.      so, it will use _p_s_r_i_p(1) to convert the PostScript to Stream TIFF and
  26.      display that.  If the file is neither Stream TIFF nor PostScript, _v_s_t_i_f_f
  27.      will try to run _f_i_l_e_c_o_n_v_e_r_t(1) to convert it to PostScript.
  28.  
  29.    CCCCoooommmmmmmmaaaannnndddd LLLLiiiinnnneeee OOOOppppttttiiiioooonnnnssss
  30.      _v_s_t_i_f_f supports the following command line options in addition to the
  31.      standard Xt command line options:
  32.  
  33.      ----ssssttttddddiiiinnnn    If the ----ssssttttddddiiiinnnn command line option is present, _v_s_t_i_f_f reads
  34.                Stream TIFF data from its standard input instead of attempting
  35.                to open a file.  In the absence of the ----ssssttttddddiiiinnnn flag, _v_s_t_i_f_f
  36.                ignores its standard input.
  37.  
  38.      ----ddddeeeebbbbuuuugggg    The ----ddddeeeebbbbuuuugggg flag instructs _v_s_t_i_f_f to print the values of the
  39.                TIFF tags of each image it reads.  The tag values are printed
  40.                to standard error.  This can be useful for debugging the
  41.                development of filters that output Stream TIFF data.
  42.  
  43.      ----nnnnooooooooppppeeeennnn   The ----nnnnooooooooppppeeeennnn flag instructs _v_s_t_i_f_f to not allow new files to be
  44.                opened by using the FFFFiiiilllleeee menu.  If the ----nnnnooooooooppppeeeennnn flag is present,
  45.                it is an error not to provide a file name to display on the
  46.                command line.
  47.  
  48.      In addition, the following command line arguments correspond to their
  49.      similarly named resource equivalents (see next section):  ----ppppssssrrrriiiipppp,
  50.      ----ppppssssbbbbiiiittttssss, ----ppppssssccccoooolllloooorrrrssssppppaaaacccceeee, ----ppppssssffffoooorrrrmmmmaaaatttt, ----ppppssssxxxxrrrreeeessss, ----ppppssssyyyyrrrreeeessss, ----ppppsssswwwwiiiiddddtttthhhh,,,,
  51.      ----ppppssssxxxxiiiinnnncccchhhheeeessss,,,, ----ppppsssshhhheeeeiiiigggghhhhtttt,,,, ----ppppssssyyyyiiiinnnncccchhhheeeessss,,,, ----ppppssssxxxxooooffffffff,,,, ----ppppssssyyyyooooffffffff,,,, ----ppppsssspppprrrroooolllloooogggg,,,,
  52.      ----ppppssssmmmmiiiirrrrrrrroooorrrr,,,, ----ppppssssllllaaaannnnddddssssccccaaaappppeeee,,,, ----ppppsssssssshhhhoooowwwwppppaaaaggggeeee
  53.  
  54. PPPPRRRROOOOGGGGRRRRAAAAMMMM RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS
  55.      _v_s_t_i_f_f is written using the standard X toolkit and the Motif widget set.
  56.      The program accepts all standard Xt/Motif resources and command line
  57.      options. In addition to these resources the following resources are
  58.      specific to the _v_s_t_i_f_f program and may be specified by the user.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. VVVVSSSSTTTTIIIIFFFFFFFF((((1111))))                        IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                         VVVVSSSSTTTTIIIIFFFFFFFF((((1111))))
  71.  
  72.  
  73.  
  74.    GGGGeeeennnneeeerrrraaaallll RRRReeeessssoooouuuurrrrcccceeeessss
  75.      ppppooooiiiinnnntttteeeerrrrCCCCoooolllloooorrrr (class PPPPooooiiiinnnntttteeeerrrrCCCCoooolllloooorrrr)
  76.                     The foreground color for the mouse cursor.
  77.  
  78.      ppppooooiiiinnnntttteeeerrrrCCCCoooolllloooorrrrBBBBaaaacccckkkkggggrrrroooouuuunnnndddd (class PPPPooooiiiinnnntttteeeerrrrCCCCoooolllloooorrrrBBBBaaaacccckkkkggggrrrroooouuuunnnndddd)
  79.                     The background color for the mouse cursor.
  80.  
  81.      hhhhoooouuuurrrrGGGGllllaaaassssssssWWWWaaaaiiiittttCCCCuuuurrrrssssoooorrrr (class HHHHoooouuuurrrrGGGGllllaaaassssssssWWWWaaaaiiiittttCCCCuuuurrrrssssoooorrrr)
  82.                     If TTTTrrrruuuueeee, use the hour glass cursor instead of the watch
  83.                     cursor to indicate busy status.
  84.  
  85.    RRRReeeessssoooouuuurrrrcccceeeessss tttthhhhaaaatttt aaaaffffffffeeeecccctttt _p_s_r_i_p((((1111)))) ooooppppttttiiiioooonnnnssss
  86.      The following resources affect options that are passed to the _p_s_r_i_p(1)
  87.      command to convert PostScript data to Stream TIFF.  See the _p_s_r_i_p(1)
  88.      manual page for more information on _p_s_r_i_p(1).
  89.  
  90.      ppppssssRRRRiiiipppp (class PPPPSSSSRRRRiiiipppp)
  91.                     The program used to convert PostScript to Stream TIFF.
  92.                     The default is to use /_u_s_r/_l_i_b/_p_r_i_n_t/_p_s_r_i_p.
  93.  
  94.      ppppssssBBBBiiiittttssss (class PPPPSSSSBBBBiiiittttssss)
  95.                     The number of bits per pixel to output in the conversion
  96.                     from PostScript to Stream TIFF.  Corresponds to the ----BBBB
  97.                     option of _p_s_r_i_p(1).
  98.  
  99.      ppppssssCCCCoooolllloooorrrrSSSSppppaaaacccceeee (class PPPPSSSSCCCCoooolllloooorrrrSSSSppppaaaacccceeee)
  100.                     The color space to use in the conversion.  Corresponds to
  101.                     the ----CCCC option of _p_s_r_i_p(1).
  102.  
  103.      ppppssssFFFFoooorrrrmmmmaaaatttt (class PPPPSSSSFFFFoooorrrrmmmmaaaatttt)
  104.                     The format to use in the conversion.  Corresponds to the
  105.                     ----FFFF option of _p_s_r_i_p(1).
  106.  
  107.      ppppssssXXXXRRRReeeessss (class PPPPSSSSXXXXRRRReeeessss)
  108.                     The X resolution to use in the conversion.  Corresponds to
  109.                     the ----XXXX option of _p_s_r_i_p(1).
  110.  
  111.      ppppssssYYYYRRRReeeessss (class PPPPSSSSYYYYRRRReeeessss)
  112.                     The Y resolution to use in the conversion.  Corresponds to
  113.                     the ----YYYY option of _p_s_r_i_p(1).
  114.  
  115.      ppppssssWWWWiiiiddddtttthhhh (class PPPPSSSSWWWWiiiiddddtttthhhh)
  116.                     The width to use in the conversion.  Corresponds to the ----WWWW
  117.                     option of _p_s_r_i_p(1).
  118.  
  119.      ppppssssXXXXIIIInnnncccchhhheeeessss (class PPPPSSSSXXXXIIIInnnncccchhhheeeessss)
  120.                     If this resource is set and ppppssssWWWWiiiiddddtttthhhh is not, then _v_s_t_i_f_f
  121.                     will calculate the ----WWWW option to pass to _p_s_r_i_p as ppppssssXXXXIIIInnnncccchhhheeeessss
  122.                     multiplied by ppppssssXXXXRRRReeeessss.  if ppppssssWWWWiiiiddddtttthhhh is set, ppppssssXXXXIIIInnnncccchhhheeeessss has no
  123.                     effect.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. VVVVSSSSTTTTIIIIFFFFFFFF((((1111))))                        IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                         VVVVSSSSTTTTIIIIFFFFFFFF((((1111))))
  137.  
  138.  
  139.  
  140.      ppppssssHHHHeeeeiiiigggghhhhtttt (class PPPPSSSSHHHHeeeeiiiigggghhhhtttt)
  141.                     The height to use in the conversion.  Corresponds to the
  142.                     ----HHHH option of _p_s_r_i_p(1).
  143.  
  144.      ppppssssYYYYIIIInnnncccchhhheeeessss (class PPPPSSSSYYYYIIIInnnncccchhhheeeessss)
  145.                     If this resource is set and ppppssssHHHHeeeeiiiigggghhhhtttt is not, then _v_s_t_i_f_f
  146.                     will calculate the ----HHHH option to pass to _p_s_r_i_p as ppppssssYYYYIIIInnnncccchhhheeeessss
  147.                     multiplied by ppppssssYYYYRRRReeeessss.  if ppppssssHHHHeeeeiiiigggghhhhtttt is set, ppppssssYYYYIIIInnnncccchhhheeeessss has
  148.                     no effect.
  149.  
  150.      ppppssssXXXXOOOOffffffff (class PPPPSSSSXXXXOOOOffffffff)
  151.                     The X offset to use in the conversion.  Corresponds to the
  152.                     ----UUUU option of _p_s_r_i_p(1).
  153.  
  154.      ppppssssYYYYOOOOffffffff (class PPPPSSSSYYYYOOOOffffffff)
  155.                     The Y offset to use in the conversion.  Corresponds to the
  156.                     ----VVVV option of _p_s_r_i_p(1).
  157.  
  158.      ppppssssPPPPrrrroooolllloooogggg (class PPPPSSSSPPPPrrrroooolllloooogggg)
  159.                     The value of this resource is the path name of a
  160.                     PostScript prolog file for _p_s_r_i_p(1) to execute before
  161.                     processing its input.  This corresponds to the ----IIII option
  162.                     of _p_s_r_i_p(1).
  163.  
  164.      ppppssssMMMMiiiirrrrrrrroooorrrr (class PPPPSSSSMMMMiiiirrrrrrrroooorrrr)
  165.                     If TTTTrrrruuuueeee, the image is mirrored in the conversion process.
  166.                     Corresponds to the ----ffff option of _p_s_r_i_p(1).
  167.  
  168.      ppppssssLLLLaaaannnnddddSSSSccccaaaappppeeee (class PPPPSSSSLLLLaaaannnnddddSSSSccccaaaappppeeee)
  169.                     If TTTTrrrruuuueeee, force landscape mode in the conversion.
  170.                     Corresponds to the ----llll option of _p_s_r_i_p(1).
  171.  
  172.      ppppssssSSSShhhhoooowwwwPPPPaaaaggggeeee (class PPPPSSSSSSSShhhhoooowwwwPPPPaaaaggggeeee)
  173.                     if TTTTrrrruuuueeee, a showpage command is appended to a PostScript
  174.                     stream that does not already contain one.  Corresponds to
  175.                     the ----SSSS option of _p_s_r_i_p(1).
  176.  
  177. NNNNOOOOTTTTEEEESSSS
  178.      _v_s_t_i_f_f is NOT a general purpose TIFF viewer.  _i_m_g_v_i_e_w(1) can be used to
  179.      view TIFF files that vstiff cannot open.
  180.  
  181.      _v_s_t_i_f_f ignores any print specific tags written to the STIFF stream by the
  182.      function _P_S_T_W_r_i_t_e_I_m_a_g_e_H_e_a_d_e_r(3).
  183.  
  184. FFFFIIIILLLLEEEESSSS
  185.      /usr/lib/X11/app-defaults/VStiff    Program resource file
  186.      /usr/tmp/vstiff*                    Temporary files
  187.  
  188. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  189.      _p_s_r_i_p(1), _f_i_l_e_c_o_n_v_e_r_t(1), _z_o_o_m_s_t_i_f_f(1), _i_m_g_v_i_e_w(1).
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.